请求
curl --location 'https://openapi.gs-robot.com/openapi/v3/schedules/plans/simple/update' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{token}}' \
--data '{
"dayOfMonth": 29,
"month": 8,
"operationType": 2,
"planStartTime": "11:00",
"planStopTime": "12:00",
"planUuid": "00000000-0000-4000-8000-000000000001",
"robotSn": "TEST00-0000-000-B088",
"taskName": "工作日清洁排班(已调整)",
"year": 2026
}'
版本限制:本接口仅支持 AIO1.6 及以上软件版本。
注意事项
- 本接口支持部分更新。除
robotSn、planUuid、operationType、year、month、dayOfMonth外,只需传需要修改的字段;未传的业务字段保留原值,不建议传null。 year、month、dayOfMonth仅用于定位目标日期。operationType=1仅修改该日期的排班,operationType=2修改该日期及未来所有排班。mapResourceList一旦传入会整体替换原资源列表;每项必须包含mapId、mapResourceId、mapResourceType,并使用/openapi/v3/maps/schedule-resources/list的实际返回值。workMode一旦传入,mode必填,所有字段必须参考资源查询接口的实际workModes。若仅凭mode不能唯一匹配,请补充subType、type或strength。taskAdvanceConfig按子字段合并,未传的子字段保留原值。- 写接口的
planExecuteType使用整数1(定时任务)或2(定量任务)。定量任务可用"planStopTime": ""清除原结束时间;定时任务的结束时间不能为空。 - 时间格式为
HH:mm(24 小时制)。非空结束时间必须晚于开始时间,不支持跨午夜。
输出
{
"code": 0,
"data": {},
"msg": "success"
}